Skip to content

Skycultures: Byname#4444

Merged
gzotti merged 3 commits intomasterfrom
SC/byname
Aug 8, 2025
Merged

Skycultures: Byname#4444
gzotti merged 3 commits intomasterfrom
SC/byname

Conversation

@gzotti
Copy link
Copy Markdown
Member

@gzotti gzotti commented Aug 6, 2025

Description

In 25.2 we have introduced a new naming scheme with many name parts. We also started using the well-known explanatory name translations as actual translated names given that the "native" name of IAU constellations is Latin, which however many users dislike when the name in user language is spelled differently. It is better to use a new tag "byname" for these explanatory additions, and allow selection if this part is really wanted.

Currently the byname is only displayed (if selected). You cannot search for it. Given the few occurrences, I don't miss it.

Fixes #4388, #4442

Screenshots (if appropriate):

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • This change requires a documentation update
  • Housekeeping

How Has This Been Tested?

Test Configuration:

  • Operating system: Win11
  • Graphics Card: irrelevant

Checklist:

  • My code follows the code style of this project.
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation (header file)
  • I have updated the respective chapter in the Stellarium User Guide
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • Any dependent changes have been merged and published in downstream modules

@gzotti gzotti added this to the 25.3 milestone Aug 6, 2025
@gzotti gzotti self-assigned this Aug 6, 2025
@gzotti gzotti added enhancement Improve existing functionality importance: high Obvious error, very annoying, but no crash subsystem: skycultures The issue is related to skycultures of planetarium... purpose: cultural astronomy Issues, pull requests and proposals with cultural astronomy purposes labels Aug 6, 2025
@github-actions github-actions bot requested review from 10110111, alex-w and sushoff August 6, 2025 11:27
@github-actions
Copy link
Copy Markdown

github-actions bot commented Aug 6, 2025

Hello @gzotti!

Thank you for the suggested improvement.

@github-actions
Copy link
Copy Markdown

github-actions bot commented Aug 6, 2025

Great PR! Please pay attention to the following items before merging:

Files matching src/**/*.cpp:

  • Are possibly unused includes removed?

Files matching guide/**:

  • Did you remember to update screenshots to match new updates?
  • Did you remember to grammar check in changed part of documentation?

Files matching skycultures/**:

  • Did you remember to update skycultures/CMakeLists.txt file respectively to changes in sky cultures?
  • Did you remember to define classification parameter in sky cultures (see index.json file)?
  • Did you remember to define license parameter in sky cultures (see description.md file)?
  • Did you remember to define region parameter in sky culture (see index.json file)?

This is an automatically generated QA checklist based on modified files.

@alex-w
Copy link
Copy Markdown
Member

alex-w commented Aug 6, 2025

Where is the code for extraction byname tag into pot file?

@gzotti
Copy link
Copy Markdown
Member Author

gzotti commented Aug 6, 2025

Good question. Where do I find the code for extraction of the other translatable strings for skycultures? (E.g. pronounce tag)

@gzotti gzotti moved this from Backlog to In progress in Skycultures 2.0 Aug 6, 2025
@gzotti gzotti moved this from In progress to In review in Skycultures 2.0 Aug 6, 2025
@alex-w
Copy link
Copy Markdown
Member

alex-w commented Aug 6, 2025

Please check util/skycultures

@gzotti
Copy link
Copy Markdown
Member Author

gzotti commented Aug 6, 2025

I hope this works, I never tested these tools.

@10110111
Copy link
Copy Markdown
Contributor

10110111 commented Aug 6, 2025

Aren't bynames supposed to be translated? Your change to generate-pot.py will only update the comments for translators, but not the byname itself.

You can simply run the script yourself to see how it will change the .pot. You don't have to commit the .pot itself for now, resetting its change after checking the results, but you should try the script anyways. Any dependencies are installable via pip.

@gzotti
Copy link
Copy Markdown
Member Author

gzotti commented Aug 6, 2025

bynames should be translated, and 'pronounce' as well. But is that implemented somewhere?

@10110111
Copy link
Copy Markdown
Contributor

10110111 commented Aug 6, 2025

and 'pronounce' as well

Oh really? No, at least judging by the .pot file, these aren't extracted. So in addition to if english: there should be cases for all the translatable others.

@gzotti
Copy link
Copy Markdown
Member Author

gzotti commented Aug 7, 2025

This seems to work. Not sure about correct uniqueness (context?), though.

@alex-w
Copy link
Copy Markdown
Member

alex-w commented Aug 8, 2025

This is good for me, but please check the CodeFactor warnings

@gzotti
Copy link
Copy Markdown
Member Author

gzotti commented Aug 8, 2025

I fixed the whitespace warning. However, the extraction of pronounce in light of Chinese "added" name parts is beyond my current reading level. I marked where I see missing functionality. Anybody else?

@alex-w
Copy link
Copy Markdown
Member

alex-w commented Aug 8, 2025

OK for me

@gzotti gzotti merged commit ca0dc97 into master Aug 8, 2025
27 of 29 checks passed
@gzotti gzotti deleted the SC/byname branch August 8, 2025 12:22
@github-project-automation github-project-automation bot moved this from In review to Done in Skycultures 2.0 Aug 8, 2025
@10110111
Copy link
Copy Markdown
Contributor

10110111 commented Aug 8, 2025

Running the script gives some entries like this:

#. Chinese constellation, native: 八谷, pronounce: Ba Gu
#. Chinese Chenzhuo Sky (3rd Century) constellation, native: 八谷, pronounce: Ba
#. Gu
#. Chinese Song Dynasty Sky constellation, native: 八谷, pronounce: Ba Gu
msgid "Ba Gu"
msgstr ""

Since it's an entry for the "pronounce" field, the comment should also say the English version if available, just like the "english" fiels have the transcribed versions.


Not quite related, but I also get some entries like this:

#. Babylonian (Seleucid) constellation, native:  , pronounce: Alu
msgid "Alu"
msgstr ""

This has already existed before this PR, but why do we have non-empty native names that consist just of a single space?

And this is even uglier:

#. Chinese Song Dynasty Sky constellation, native:  , pronounce:  
msgid " "
msgstr ""

This is an entry with three names, all of which are garbage: "common_name": {"english": "", "native": " ", "pronounce": " "}.

@gzotti
Copy link
Copy Markdown
Member Author

gzotti commented Aug 8, 2025

A right, the english could go into the comment of the pronounce.
I don't know what to do about missing data when authors provide empty or whitespace strings.

@alex-w alex-w added the state: published The fix has been published for testing in weekly binary package label Aug 19, 2025
@github-actions
Copy link
Copy Markdown

Hello @gzotti!

Please check the fresh version (development snapshot) of Stellarium:
https://github.com/Stellarium/stellarium-data/releases/tag/weekly-snapshot

@alex-w alex-w removed the state: published The fix has been published for testing in weekly binary package label Sep 29, 2025
@github-actions
Copy link
Copy Markdown

Hello @gzotti!

Please check the latest stable version of Stellarium:
https://github.com/Stellarium/stellarium/releases/latest

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement Improve existing functionality importance: high Obvious error, very annoying, but no crash purpose: cultural astronomy Issues, pull requests and proposals with cultural astronomy purposes subsystem: skycultures The issue is related to skycultures of planetarium...

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

constellation names

3 participants